/* 
 * PROJECT: NyARToolkitCS
 * --------------------------------------------------------------------------------
 * This work is based on the original ARToolKit developed by
 *   Hirokazu Kato
 *   Mark Billinghurst
 *   HITLab, University of Washington, Seattle
 * http://www.hitl.washington.edu/artoolkit/
 *
 * The NyARToolkitCS is Java edition ARToolKit class library.
 * Copyright (C)2008-2009 Ryo Iizuka
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 * 
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 * 
 * For further information please contact.
 *	http://nyatla.jp/nyatoolkit/
 *	<airmail(at)ebony.plala.or.jp> or <nyatla(at)nyatla.jp>
 * 
 */
using System;
using System.Diagnostics;
namespace jp.nyatla.nyartoolkit.cs.core
{

    /**
     *　このクラスは、{@link NyARLabeling_ARToolKit}の出力するラべリング画像を格納するラスタです。
     *　データに、インデクス化したラべリング画像と、ラベルの配列、画像のインデクスの配列を持ちます。
     * <p>ラベル画像-
     * ラべリング画像は、ラベルのインデクス値を格納します。インデクス値は、{@link #getIndexArray}で
     * 得られるインデクス配列を使って、ラベル番号に変換できます。
     * 例えば、インデクス番号nの画素は、ラベル番号L[n]になります。
     * </p>
     */
    public class NyARLabelingImage : NyARRaster_BasicClass
    {
        private const int MAX_LABELS = 1024 * 32;
        /** 画像バッファ*/
        protected int[] _buf;
        /** ラベル配列のスタック*/
        protected NyARLabelingLabelStack _label_list;
        /** インデクステーブル*/
        protected int[] _index_table;
        /** インデクステーブルが有効であるかを示す値*/
        protected bool _is_index_table_enable;
        /**
         * コンストラクタです。
         * ラべリング画像のサイズを指定して、インスタンスを生成します。
         * @param i_width
         * ラスタの幅を指定します。
         * @param i_height
         * ラスタの高さを指定します。
         * @
         */
        public NyARLabelingImage(int i_width, int i_height)
            : base(i_width, i_height, NyARBufferType.INT1D)
        {
            this._buf = new int[i_height * i_width];
            this._label_list = new NyARLabelingLabelStack(MAX_LABELS);
            this._index_table = new int[MAX_LABELS];
            this._is_index_table_enable = false;
            //生成時に枠を書きます。
            drawFrameEdge();
            return;
        }
        /**
         * 画像バッファを返します。バッファの形式は、{@link NyARBufferType#INT1D}(int[])です。
         */
        public override object getBuffer()
        {
            return this._buf;
        }
        public override bool hasBuffer()
        {
            return this._buf != null;
        }
        /**
         * このクラスでは、関数は機能しません。
         */
        public override void wrapBuffer(object i_ref_buf)
        {
            NyARException.notImplement();
        }
        /**
         * この関数は、矩形エッジ（画像を囲む枠）を書きます。
         * ARToolKit互換のコーナー検出の前処理に必要なため、実装しています。
         */
        public void drawFrameEdge()
        {
            int w = this._size.w;
            int h = this._size.h;
            // NyLabelingImageのイメージ初期化(枠書き)
            int[] img = (int[])this._buf;
            int bottom_ptr = (h - 1) * w;
            for (int i = 0; i < w; i++)
            {
                img[i] = 0;
                img[bottom_ptr + i] = 0;
            }
            for (int i = 0; i < h; i++)
            {
                img[i * w] = 0;
                img[(i + 1) * w - 1] = 0;
            }
            return;
        }

        /**
         * この関数は、ラベルのインデクステーブルを返します。
         * <p>格納値 - 
         * 値がnullの時はラベル番号そのものがラスタに格納されていますが、
         * null以外の時はラスタに格納されているのはインデクス番号です。
         * インデクス番号とラベル番号の関係は、以下の式で表されます。
         * ラベル番号n,インデクス番号i: n=indextable[i]
         * </p>
         * @return
         * ラベリング結果がインデックステーブルを持つ場合、その配列を返します。
         * 持たない場合、nullを返します。
         */
        public int[] getIndexArray()
        {
            return this._is_index_table_enable ? this._index_table : null;
        }
        /**
         * この関数は、ラベル情報を格納したスタックオブジェクトを返します。
         * @return
         * 現在の画像に対するラベルのスタック
         */
        public NyARLabelingLabelStack getLabelStack()
        {
            return this._label_list;
        }
        /**
         * この関数は、インスタンスの状態をリセットします。
         * リセット後にインスタンスのラベルスタックはクリアされますが、画像情報は未定義値になります。
         * @param i_label_index_enable
         * モード値。現在指定できるのは、trueのみです。
         */
        public void reset(bool i_label_index_enable)
        {
            Debug.Assert(i_label_index_enable == true);//非ラベルモードは未実装
            this._label_list.clear();
            this._is_index_table_enable = i_label_index_enable;
            return;
        }
        /**
         * この関数は、i_labelのラベルのクリップ領域が上辺に接している点の、x座標を返します。
         * NyARToolkitでは、ラベルの輪郭をトレースするときに、その始点を探索するために使います。
         * @param i_label
         * 探索するラベル
         * @return
         * ラベルの上辺クリップとの接点となる、x位置
         */
        public int getTopClipTangentX(NyARLabelingLabel i_label)
        {
            int pix;
            int i_label_id = i_label.id;
            int[] index_table = this._index_table;
            int[] limage = this._buf;
            int limage_ptr = i_label.clip_t * this._size.w;
            int clip1 = i_label.clip_r;
            // p1=ShortPointer.wrap(limage,j*xsize+clip.get());//p1 =&(limage[j*xsize+clip[0]]);
            for (int i = i_label.clip_l; i <= clip1; i++)
            {// for( i = clip[0]; i <=clip[1]; i++, p1++ ) {
                pix = limage[limage_ptr + i];
                if (pix > 0 && index_table[pix - 1] == i_label_id)
                {
                    return i;
                }
            }
            //あれ？見つからないよ？
            throw new NyARException();
        }
        public override object createInterface(Type iIid)
        {
            throw new NyARException();
        }

    }
}
